home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / program / gcc / ixemul40.lha / ixemul-bin / INSTALL < prev    next >
Text File  |  1995-08-28  |  6KB  |  172 lines
  1.  
  2.          IXEMUL  LIBRARY  INSTALLATION  NOTES
  3.  
  4.             (last updated 6/12/95)
  5.  
  6.  
  7. =====================
  8. DISTRIBUTION CONTENTS
  9. =====================
  10.  
  11. The net ixemul library distribution consists of two archives, one for the
  12. runtime files and one for the source, where XXYY is the major and minor
  13. version numbers:
  14.  
  15.   ixemulXXYY-bin.lha    ixemul.library, *crt*.o, includes, libc.a, etc
  16.   ixemulXXYY-src.lha    Complete source code for ixemul library
  17.  
  18. Note that version 41.0 would be 4100 and 41.10 would be 4110.
  19.  
  20. The ixemulXXYY-bin.lha archive contains various readme and copyright files
  21. that do not need to be installed anywhere, and another archive "runtime.lha"
  22. that can be extracted relative to the gnu: directory to put all the files in
  23. their standard location.
  24.  
  25. The ixemulXXYY-src.lha archive contains all the source, relative to a
  26. directory "ixemul-XX.YY".
  27.  
  28. ========================
  29. INSTALLING RUNTIME FILES
  30. ========================
  31.  
  32. For the moment, you must manually install the files.  Eventually there will
  33. be an installer script available that you can use with the standard AmigaDOS
  34. installer program to make installation more WorkBench friendly.
  35.  
  36. First backup any files in gnu: that will get overwritten during the install,
  37. if you wish to preserve them.  These files typically are:
  38.  
  39.     gnu:bin/ixconfig
  40.     gnu:lib/bcrt0.o
  41.     gnu:lib/crt0.o
  42.     gnu:lib/rcrt0.o
  43.     gnu:lib/libc.a
  44.     gnu:lib/libb/libc.a
  45.     gnu:include        (lots of files, but probably not all)
  46.     gnu:man            (lots of files, but probably not all)
  47.     gnu:Sys/libs/ixemul*    (all the old versions of the library)
  48.  
  49. Next make a work directory and unpack the binary distribution archive.
  50. If you have sufficient memory, the ram disk is a fine place for this:
  51.  
  52.     copy ixemulXXYY-bin.lha ram:
  53.     cd ram:
  54.     lha -mraxe x ixemulXXYY-bin.lha
  55.  
  56. This will create a subdirectory called ixemul-bin, with the following
  57. files:
  58.  
  59.     ixemul-bin/COPYING
  60.     ixemul-bin/COPYING.LIB
  61.     ixemul-bin/INSTALL    (this file)
  62.     ixemul-bin/NEWS
  63.     ixemul-bin/BUGS
  64.     ixemul-bin/TODO
  65.     ixemul-bin/README
  66.     ixemul-bin/README.ixtrace
  67.     ixemul-bin/runtime.lha
  68.  
  69. Extract the contents of runtime.lha to the gnu: tree, overwriting any
  70. existing copies of the files:
  71.  
  72.     cd ixemul-bin
  73.     lha -mraxe x runtime.lha gnu:
  74.  
  75. By default, the version of ixemul.library that will be used is for any m68k
  76. CPU and is not compiled to use an FPU.  If you wish to install a version
  77. better suited to your machine, say an 040 version using the built in fpu,
  78. then do something like the following:
  79.  
  80.     cd gnu:Sys/libs
  81.     rename ixemul.library ixemul000.library
  82.     copy ixemul040fpu.library ixemul.library clone
  83.  
  84. Then either reboot or run a program to flush the existing ixemul.library (if
  85. any) from memory.
  86.  
  87. =======================
  88. INSTALLING SOURCE FILES
  89. =======================
  90.  
  91. To extract the source code, simple cd to a directory where you would like
  92. the source code directory to be created, and extract the source archive
  93. there:
  94.  
  95.     cd gnu-src:
  96.     lha -mraxe x ixemulXX.YY-src.lha
  97.  
  98. Note that this will create the directory ixemul-XX.YY and populate it with
  99. all the source files.
  100.  
  101. To rebuild the library, all that is needed is to run the configure script
  102. and then run make.  Note that at the moment, you have to use separate build
  103. and source directories and the path you use to run "configure" has to be
  104. an absolute one, not a relative one (see below).  That is, you leave the
  105. source tree untouched and create a separate build tree in which all the
  106. compiled files will be placed:
  107.  
  108.     cd gnu-build:
  109.     makedir ixemul-XX.YY    (must not be source directory at the moment)
  110.     cd ixemul-XX.YY
  111.     sh /gnu-src/ixemul-XX.YY/configure m68k-cbm-amigados
  112.  
  113. This will create a Makefile and several subdirectories with other Makefiles.
  114. Note the section in the Makefile that looks like:
  115.  
  116.     all:
  117.         $(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
  118.         $(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
  119.         $(MAKE) build CPU=68020 FPU=68881      BASE=no-baserel
  120.         $(MAKE) build CPU=68020 FPU=68881      BASE=baserel
  121.         $(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
  122.         $(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
  123.         $(MAKE) build CPU=68030 FPU=68881      BASE=no-baserel
  124.         $(MAKE) build CPU=68030 FPU=68881      BASE=baserel
  125.         $(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
  126.         $(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
  127.         $(MAKE) build CPU=68040 FPU=68881      BASE=no-baserel
  128.         $(MAKE) build CPU=68040 FPU=68881      BASE=baserel
  129.         @(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
  130.  
  131. By default, all of the versions of ixemul.library are build by make.  This
  132. can take a very long time (about a day on a 40MHz 040 WarpEngine for
  133. example, probably much longer on other machines).
  134.  
  135. If you only want to build one particular version of the library and runtime
  136. files to test, just comment out the lines you don't want.  I.E.  to build a
  137. 68040+68881 version, the above lines should be changed to:
  138.  
  139.     all:
  140.         $(MAKE) build CPU=68000 FPU=soft-float BASE=no-baserel
  141.         $(MAKE) build CPU=68000 FPU=soft-float BASE=baserel
  142.     #        $(MAKE) build CPU=68020 FPU=68881      BASE=no-baserel
  143.     #        $(MAKE) build CPU=68020 FPU=68881      BASE=baserel
  144.     #        $(MAKE) build CPU=68020 FPU=soft-float BASE=no-baserel
  145.     #        $(MAKE) build CPU=68020 FPU=soft-float BASE=baserel
  146.     #        $(MAKE) build CPU=68030 FPU=68881      BASE=no-baserel
  147.     #        $(MAKE) build CPU=68030 FPU=68881      BASE=baserel
  148.     #        $(MAKE) build CPU=68030 FPU=soft-float BASE=no-baserel
  149.     #        $(MAKE) build CPU=68030 FPU=soft-float BASE=baserel
  150.         $(MAKE) build CPU=68040 FPU=68881      BASE=no-baserel
  151.         $(MAKE) build CPU=68040 FPU=68881      BASE=baserel
  152.         @(cd libsrc && $(MAKE) $(FLAGS_TO_PASS))
  153.  
  154. Note that you have to build the 68000 version in any case, since the
  155. compiler runtime files (*crt*.o, libc.a, libbc.a) are generic 68000 code.
  156.  
  157. Then just run "make" in the build directory:
  158.  
  159.     cd gnu-build:ixemul-XX.YY
  160.     make
  161.  
  162. ==============
  163. REPORTING BUGS
  164. ==============
  165.  
  166. Please report problems or bugs to Fred Fish (fnf@amigalib.com), who is the
  167. current ixemul library coordinator.  Even better than a bug report is a bug
  168. fix, which typically would be a context diff file for one or more ixemul
  169. source files.
  170.  
  171. -Fred Fish (fnf@amigalib.com)
  172.